home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / apps / 267 / tab142 / tabook14.asc < prev   
Text File  |  1989-01-14  |  15KB  |  272 lines
  1.                                The Address Book
  2.                      List Finder Desk Accessory/Application
  3.  
  4.                               A Shareware Program
  5.                                by Robert M. Balay
  6.                   Technocraft Independent Software Development
  7.  
  8.     Having trouble keeping up with your friends' addresses?  I've got just the
  9. thing for you!  After scratching out most of the space in my own personal
  10. address book, I decided to write a program to keep track of addresses for me.
  11. But before I had a chance to sit down at the keyboard and hack one out, a
  12. couple of people beat me to the punch.  Now I've got to admit, I sat down and
  13. tried to use their programs.  I really did!  But they were so awkward to use,
  14. that I just continued to use my old Bates list-finder (Model "A" - The Bates
  15. MFG Co., Hackettstown, N.J.).  Unfortunately, I just wasn't able to continue
  16. with the scratched out addresses and I didn't feel like going to the store,
  17. buying a replacement insert, and writing down every address all over again.
  18. So, I thought, wouldn't it be a great idea to have the list finder on the
  19. computer!  And so, The Address Book came to be.
  20.  
  21.  
  22.      Version 1.0 was a basic, color only, prototype.  The slider bar was really
  23. imprecise (just like the real thing), with no up/down arrows.  Plus, when the
  24. 'close window' symbol was clicked while in one of the sections, the program
  25. would quit as soon as the user left the section.  This was a bit confusing for
  26. some users.
  27.     Version 1.1 corrected these problems.  Arrows were added for more
  28. precise control over the slider bar, and the 'close window' symbol was covered
  29. up while in a section.  Support for dialing the telephone number via modem was
  30. also added.
  31.     Version 1.2 added monochrome (high resolution) support, since I
  32. also use a monochrome monitor occasionally.  As fate would have it, there was
  33. a major bug in the program that caused the same name to be written to the
  34. address book file several times.
  35.     Version 1.21 corrected that problem, and the result was a fully operational
  36. program.
  37.     Version 1.3 incorporated several new features, including the option of
  38. pressing a key in order to move the selector directly to the section you
  39. want, and a repeat function for the stepping through the sections by pressing
  40. the right mouse button.  The dial feature was also fixed, so that you no
  41. longer have to select [Dial] twice before you get a response.
  42.     Version 1.35 included a new format with 2 lines for addresses.
  43. This version was distributed to the first registered users along with a
  44. conversion program and a program to print out the contents of the entire
  45. address book.
  46.     Versions 1.36, 1.37, and 1.38 included several refinements to 1.35.
  47.     Version 1.40 is the shareware version desk accessory.  It includes the
  48. print-out program from within the desk accessory by pressing Control-P.  The
  49. desk accessory also sorts the names within the section before displaying them.
  50. In addition, the desk accessory also uses smaller data files for the actual
  51. address book pictures.  Thus, less disk space is wasted by the big Degas
  52. pictures that were previously used.
  53.     Since I upgraded from a 1040ST to a Mega ST2 after writing the original
  54. program, I had to make some other minor changes to the program to get it
  55. to  work properly on the new machine.  The effects that these changes will
  56. have on the older machines is unknown.
  57.     Version 1.41 is an update to the desk accessory.  Screen redrawing routines
  58. were corrected so that other windows on screen with the address book are not
  59. "swallowed up" when The Address Book attempts to redraw.
  60.     Version 1.42 is a further update that allows the accessory to boot when
  61. the picture data files are not present.  Versions prior to this may cause
  62. some problems during boot if data files are not on the root directory of the
  63. boot disk.
  64.  
  65.  
  66.  
  67.     What The Address Book Does
  68.  
  69.     The Address Book is an address filing program that utilizes the list-
  70. finder metaphor as a user interface.  This makes The Address Book infinitely
  71. easier to use than most mailing list programs that offer the capability to
  72. search for a given name.  It stores the name, address, and phone number of up
  73. to 22 people in 23 sections (466 total addresses).  Addresses are indexed by
  74. name within each alphabetical section.  Each address may be printed, with or
  75. without the phone number, in a format suitable for mailing labels.  And, the
  76. capability to dial a telephone number, using the modem, is available.  The
  77. user never has to deal with remembering the name of the address book file,
  78. because the program always uses the same file.  This removes some of the
  79. complication found in other mailing list programs.
  80.  
  81.     How To Use The Address Book
  82.  
  83.     The overall operation of the program is easy.  You probably won't even
  84. need these instructions.  But, just in case something is unclear...
  85.  
  86.     * To Load - Click on the ADRBOOK.PRG icon in medium or high resolution.
  87. The program does not operate in low res.
  88.  
  89.     * To Select a Section - Drag the window scroller bar to the desired
  90. alphabetic character.  The character should be centered in the scroller box.
  91. Clicking on the up/down arrows causes the scroller bar to move up one section,
  92. or down one section.  Clicking on the filled portion of the scroller bar
  93. (paging) causes the scroller bar to move up or down 5 sections at a time.
  94. Once you have clicked on one of the arrows, pressing the right mouse button
  95. will cause the scroller bar to continue in the selected direction, one step at
  96. a time, until the mouse button is released.  (Not necessary in machines with
  97. the new TOS ROMs.)  You may also select the section you want by pressing the
  98. appropriate letter key.
  99.  
  100.     * To Open the Book - Click on the 'full window' symbol in the upper right
  101. hand corner of the window.  Names previously entered in that section will
  102. appear, followed by blank lines, representing the amount of space remaining in
  103. that section.
  104.  
  105.     * To Enter a New Address - Click on any one of the empty lines.  A dialog
  106. box will appear with the words 'New Entry' where you will enter the name.  Use
  107. the [Esc] key to clear the line and enter the name information.  Use the [Tab]
  108. key to move to the successive lines.  Pressing the up arrow will move you back
  109. to the preceding line, if you so desire.  (Normal dialog box editing).  When
  110. you are done entering the address, you can either press the [Return] key, or
  111. use the mouse and click on the [Ok] button within the dialog box.  Once the
  112. address has been entered, the new name will be displayed in the section.
  113.  
  114.     * To Call Up an Address - Click on the name you want to see.  A dialog box
  115. will appear (the same one you used to enter the information) with the address
  116. and telephone information.  You may then make a change by moving to the line
  117. you want to change (down arrow, or [Tab] keys, or use the mouse to point to
  118. the line where you want the cursor), move the cursor to the part of the line
  119. you want to change ([Esc] key to clear the line and start at the beginning, or
  120. left arrow to move the cursor to the item within the line that you want to
  121. change), and enter any new information or corrections.  Press [Return] or
  122. click on the [Ok] button to enter the corrections, or when you're done looking
  123. at the address.
  124.  
  125.    * To Delete an Address - Call up the address, using the procedure described
  126. above, and click on the [Delete] button in the dialog box.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.    * To Print an Address - Call up the address, using the procedure described
  135. above, and click on the [Print] button in the dialog box.  The dialog box will
  136. go away and a new dialog box will show up in its place.  In the center of the
  137. 'print' dialog box, is a box which says, "Include Phone # In Output".  If you
  138. are printing mailing labels, chances are, you will not want this.  But if you
  139. are printing out a reference copy, you can click on this box to have the phone
  140. number printed out with the address.  When this option is active, a check mark
  141. will appear next to text within the box.  There is also a box for including
  142. the second address line in the output.  This works the same way as the
  143. "include phone number" option.  You will also be prompted for the number of
  144. copies you want to print.  The default is one copy.  If you wish to print out
  145. multiple copies for mailing labels, you can enter any number from 1 to 999(!).
  146. Ensure that your printer is turned on before attempting to print.  If the
  147. printer is not on, the program may abort.
  148.  
  149.     * To Dial a Phone Number - Call up the address, using the procedure
  150. described above.  Click on the [Dial] button in the dialog box.  The dialog
  151. box will disappear and another dialog box will appear with a dial string in
  152. it.  For example "ATDT 800-234-5678__"  If the number is long distance, you
  153. will have to move the cursor back to the space before the area code and enter
  154. a '1'.  Use the left arrow key to move the cursor.  When you type the '1', the
  155. rest of the string will move over.  If you are not using a Hayes compatible
  156. modem, you may have to change "ATDT" to whatever your modem requires as a dial
  157. command.  Or, if you do not have touch-tone capability, you may have to change
  158. "ATDT" to "ATDP", for pulse dialing.  Ensure that the modem is connected and
  159. turned on before attempting to use the dial feature.  Also note that the modem
  160. will stay on line for as long as it is programmed to wait for a carrier tone,
  161. so don't be too surprised when it drops off-line in the middle of your
  162. conversation!
  163.  
  164.     * Exiting From a Section - To exit from a section, you must first have no
  165. dialog boxes present.  If you have dialog boxes present on the screen, hit
  166. [Return] until they go away!  Place the tip of the pointer in the [EXIT] box
  167. at the bottom left of the section and hold the left mouse button until the
  168. pointer turns into a bee (if any changes were made, the section will be saved
  169. to the disk file, which may take a while) or the book closes, revealing the
  170. section selector.
  171.  
  172.     * Leaving The Address Book - From the section selector, click on the
  173. 'close window' symbol in the upper left corner of the window.  The desktop
  174. palette will be restored, and the program will exit to the desktop, or the
  175. calling program.  You may also press the [Undo] key, which will ask you if
  176. you really want to exit.
  177.  
  178.     More Notes About The Address Book
  179.  
  180.     The names and addresses are stored in a file called, ADRBOOK.FIL.  If the
  181. program is unable to find this file, it will create a new file for you.  If
  182. you move the program to a new folder, or new disk, don't forget to move the
  183. address file with it.
  184.  
  185.     The section selector screens are stored in the files ADRBOOK.PI2 (medium
  186. res) and ADRBOOK.PI3 (high res).  If you don't plan on using one of the
  187. resolutions, you can delete one of these files and save 32K of disk space.
  188. For example, if you own a color monitor and won't be using high resolution,
  189. you can delete the file ADRBOOK.PI3.  Additionally, these files must be
  190. maintained in the same folder, on the same disk drive, as ADRBOOK.PRG.  So
  191. don't forget to move these files, if you copy to a new disk, as well.
  192.  
  193.     Whenever a change is made to the address file, a backup file containing
  194. the old information is created.  This file is called, ADRBOOK.BAK.  If for
  195. some reason the address file is corrupted, or you want to restore the book to
  196. it's condition before changes were made, you can either copy the back up file
  197. to a new file called, ADRBOOK.FIL, or rename the back up file to ADRBOOK.FIL.
  198. Deleting the ADRBOOK.BAK file will not have any effect on the operation of the
  199. program.
  200.  
  201.     Acknowledgments:
  202.  
  203.     This program was written using the Personal Pascal compiler, version 2.00.
  204.  
  205.     Portions of this program are copyright (C) 1986 by CCD and OSS - Used by
  206. permission, OSS.
  207.     Screen blitting routines used in the program were taken from ST Log, issue
  208. #15, June 1987, by David Plotkin.
  209.  
  210.     Graphics screens were developed using Degas Elite, by Tom Hudson
  211. (Batteries Included division of Electronic Arts)
  212.  
  213. =============================================================================
  214.     Planned Future upgrades for registered users:
  215.  
  216.     1.50  Unlimited space for addresses in each section, new format with
  217.           longer fields for telephone numbers, modem dialer configuration,
  218.           better looking dialog boxes, GEM print-out utility, less run-time
  219.           memory space required.
  220. =============================================================================
  221.  
  222.     This is user supported Shareware.  If you like the utility of this
  223. program, then your support is solicited!  For $15.00, you can be a registered
  224. owner of this program, which means that you're entitled to full support and
  225. upgrades for a nominal charge (postage and disk costs).  The Pascal source
  226. code is available for $50.00, if you want to modify the program to your own
  227. specifications, or just want to see how it's done.  If you don't like the
  228. program, give your copy to a friend.  All of the files included in this ARC
  229. file should be passed along intact!  The files included are: ADRBK141.ACC,
  230. TAB1.DAT, TAB2.DAT, and TABOOK.DOC.  If you do not have all of these files,
  231. please let me know.  Bug reports are solicited, as well.
  232.     A lot of time and effort went into this package in order to bring it to
  233. you.  I do it for the enjoyment of programming, but I am working my way
  234. through college and every little bit helps.  $15.00 is a drop in the bucket,
  235. when you consider the price of some commercial software.  You get it without
  236. the fancy packaging and no middlemen take a cut.
  237.     Many commercial software developers are leaving the ST community, saying
  238. that ST users are pirates and thieves, and that they can't make a decent
  239. profit.  I happen to believe otherwise.  I know a lot of ST users and not a
  240. one of them has even a single bootleg copy, myself included.  But that doesn't
  241. help matters any.  The commercial software publishers are abandoning us at an
  242. alarming rate for whatever reason.  In the future, we may all be orphans, like
  243. the TI-99 users!  In this event, the only people making new software will be
  244. the users of the machine.  People like myself don't care if the commercial
  245. software developers go to the Apple or IBM market, because we can always write
  246. whatever software we need.  But, if we're going to make it available to those
  247. of you who don't program, it is only reasonable that we expect you to help us
  248. out with a small contribution.
  249.     In my case, it's for a good cause.  I've done some small public domain
  250. programs for free, without expecting a contribution.  But, this one has taken
  251. a considerable amount of work to be a finished product; one that I hope you'll
  252. enjoy using.  Help me out and I'll always be willing to do the same for you.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.              Register by sending $15.00 check or money order to:
  260.  
  261.                               Robert Balay
  262.                               Rt. 1, Box 228
  263.                               Morrisville, NC. 27560
  264.  
  265.  
  266. You can leave bug reports, requests for support, or comments about the program
  267. to me at the following places:
  268.  
  269. CompuServe ID: 74716,101
  270. GEnie ID: RBALAY
  271.  
  272.